package com.cino.fullstack.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.cino.fullstack.entity.User;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * 用户服务接口
 *
 * @author +Le
 * @since 2025-10-20
 */
public interface UserService extends IService<User> {

    /**
     * 分页查询用户列表
     *
     * @param pageNum 页码
     * @param pageSize 每页大小
     * @param keyword 搜索关键词
     * @return 分页结果
     */
    Page<User> getUserList(Integer pageNum, Integer pageSize, String keyword);

    /**
     * 根据ID获取用户信息
     *
     * @param id 用户ID
     * @return 用户信息
     */
    User getUserById(Long id);

    /**
     * 保存用户（新增或更新）
     *
     * @param user 用户信息
     * @return 操作结果
     */
    boolean saveUser(User user);

    /**
     * 更新用户信息
     *
     * @param user 用户信息
     * @return 操作结果
     */
    boolean updateUser(User user);

    /**
     * 删除用户
     *
     * @param id 用户ID
     * @return 操作结果
     */
    boolean deleteUser(Long id);

    /**
     * 批量删除用户
     *
     * @param ids 用户ID列表
     * @return 操作结果
     */
    boolean batchDeleteUsers(List<Long> ids);

    /**
     * 检查用户是否存在
     *
     * @param id 用户ID
     * @return 是否存在
     */
    boolean existsUser(Long id);

}
